home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 242 / Issue 242 - April 2008 - DPCS0408DVD.ISO / Software Money Savers / VirtualDub / Source / VirtualDub-1.7.7-src.7z / src / helpfile / source / dialogs.lina < prev    next >
Encoding:
Text File  |  2006-03-14  |  42.3 KB  |  940 lines

  1. <lina:for-each name="/dialog-docs/dialog">
  2.     <lina:tag name="lina:create">
  3.         <lina:attrib name="file"><lina:arg name="filename"/></lina:attrib>
  4.         <lina:attrib name="title">Dialogs: <lina:arg name="name"/></lina:attrib>
  5.         <lina:body/>
  6.     </lina:tag>
  7. </lina:for-each>
  8.  
  9. <lina:data>
  10.     <dialog-docs>
  11.         <dialog name="Video filters" filename="d-videofilters.html">
  12.             <blockquote>
  13.                 <lina:image src="pics/d-videofilters.png"/>
  14.             </blockquote>
  15.             <ul>
  16.                 <li><a href="video-filters.html">Video filter reference</a></li>
  17.             </ul>
  18.  
  19.             <p>
  20.                 Video filters transform video frames sequentially, such as blurring the image,
  21.                 resizing the image frame, or applying noise reduction. VirtualDub's video filter
  22.                 system takes chains of filters, which are set up through the Video Filters dialog.
  23.             </p>
  24.             <dl>
  25.                 <lina:dt>Frame sizes</lina:dt>
  26.                 <dd>
  27.                     Each video filter in the list is shown with the size of the video frame entering
  28.                     the filter and the video frame size produced by that filter. Video filter chains
  29.                     may be created without a video loaded, and when the video is changed, the input
  30.                     and output frame sizes for each frame will change accordingly.
  31.                     <lina:note>
  32.                         If no video is loaded, VirtualDub will compute frame sizes as if a 320x240
  33.                         input were present.
  34.                     </lina:note>
  35.                 </dd>
  36.  
  37.                 <lina:dt>Filter name and parameters</lina:dt>
  38.                 <dd>
  39.                     Each filter entry has the name of the filter beside the frame sizes, as well as
  40.                     a parameter list for the filter. The parameter list is filter-specific and is
  41.                     only shown to aid in scanning the filter chain.
  42.                 </dd>
  43.  
  44.                 <lina:dt>Cropping</lina:dt>
  45.                 <dd>
  46.                     Cropping can be applied at the beginning of any filter by selecting the entry
  47.                     and selecting the <em>Cropping...</em> button. Once cropping borders are set,
  48.                     the cropped frame is reflected in the input frame size for that filter entry.
  49.  
  50.                     <lina:note>
  51.                         The post-crop width and height should never be zero or negative.
  52.                     </lina:note>
  53.                 </dd>
  54.  
  55.                 <lina:dt>Filter order</lina:dt>
  56.                 <dd>
  57.                     Filters are executed from top to bottom; use the <em>Move Up</em> and <em>Move Down</em>
  58.                     buttons move the currently selected filter up or down one slot. Frame sizes are automatically
  59.                     recomputed as filters are moved.
  60.                 </dd>
  61.  
  62.                 <lina:dt>Loading filters</lina:dt>
  63.                 <dd>
  64.                     The <em>Add Filters</em> sub-dialog has a <em>Load...</em> button for loading third-party
  65.                     video filters. These video filters need to be written specifically for VirtualDub and
  66.                     have a <tt>.vdf</tt> file extension.
  67.  
  68.                     <lina:note>
  69.                         Video filters loaded from this dialog are loaded only for the current session. If
  70.                         you want filters loaded all the time, move them under <tt>plugins\</tt>
  71.                         in VirtualDub's program directory.
  72.                     </lina:note>
  73.                 </dd>
  74.             </dl>
  75.         </dialog>
  76.  
  77.         <dialog name="Video frame rate control" filename="d-videoframerate.html">
  78.             <blockquote>
  79.                 <lina:image src="pics/d-videoframerate.png"/>
  80.             </blockquote>
  81.  
  82.             <p>
  83.                 The <em>Video frame rate control</em> dialog allows you to alter the frame rate of video,
  84.                 reduce the number of frames, or remove 3:2 pulldown.
  85.             </p>
  86.  
  87.             <dl>
  88.                 <dt>Adjusting frame rate</dt>
  89.                 <dd>
  90.                     If the source video has the wrong frame rate or doesn't natively have a frame rate
  91.                     (image sequence), you can specify one in the source correction portion of the dialog.
  92.                     You can either type in a rate, or have VirtualDub automatically choose a "same length"
  93.                     setting, such that the video and audio tracks end at the same time.
  94.  
  95.                     <lina:note>
  96.                         No frames are added or deleted by this setting, so if the video is synchronized
  97.                         with the audio beforehand it won't be after you change the frame rate. Similarly, if the video isn't
  98.                         synchronized, you may be able to fix it with this setting.
  99.                     </lina:note>
  100.  
  101.                     <lina:note>
  102.                         Manually entered frame rates are rounded to the nearest microsecond period. In particular,
  103.                         you cannot enter an exact NTSC fraction (30000/1001).
  104.                     </lina:note>
  105.                 </dd>
  106.  
  107.                 <dt>Frame rate decimation</dt>
  108.                 <dd>
  109.                     <em>Decimation</em> pulls frames from a source at regular intervals. This is useful for
  110.                     producing "thumbnail" videos with small sizes, and for dropping the rate of a video
  111.                     without introducing jerkiness due to uneven frame rate. The decimation interval must be
  112.                     a positive integer.
  113.                 </dd>
  114.  
  115.                 <dt>Inverse telecine (3:2 pulldown)</dt>
  116.                 <dd>
  117.                     <p>
  118.                         <em>3:2 pulldown</em>, or telecine, is the process by which film-rate material (24 fps) is converted to
  119.                         NTSC rate (29.97 fps). This is done by splitting the film frames into fields, and then "pulling"
  120.                         fields down in an alternating 3,2,3,2... pattern. This produces five output frames for every four
  121.                         input frames, in a characteristic pattern of three progressive frames, followed by two interlaced frames.
  122.                         The resultant 30 fps stream is then slowed down slightly to the target 29.97 fps.
  123.                     </p>
  124.                     <p>
  125.                         <em>Inverse telecine (IVTC)</em> attempts to recover the original 24 fps stream by analyzing the
  126.                         input frames and removing the duplicate fields. In <em>adaptive mode</em>, VirtualDub attempts to
  127.                         guess the position of the 3:2 pattern, while in <em>manual mode</em>, you specify the offset and polarity.
  128.                         In both cases, the input frame rate is dropped by 20%, changing a 29.97 fps input to 23.976 fps.
  129.                     </p>
  130.                     <p>
  131.                         The third mode, <em>reconstruct from blurred fields</em>, handles the case where a video has been
  132.                         telecined, and then the fields blurred together, usually by shrinking the video size. In this case
  133.                         the original frames cannot be recovered by matching fields, but can be recovered through simple
  134.                         frame algebra. The reconstructed frames will have more noise and possibly ghosting where clipping
  135.                         at black or white has occurred, but if successful the result is a smooth progressive video.
  136.                     </p>
  137.  
  138.                     <lina:note>
  139.                         All of VirtualDub's IVTC modes assume a regular 3-2 pattern. More complex telecine patterns are possible
  140.                         which cannot be removed through this system.
  141.                     </lina:note>
  142.                 </dd>
  143.             </dl>
  144.         </dialog>
  145.  
  146.         <dialog name="Video color depth" filename="d-videocolordepth.html">
  147.             <blockquote>
  148.                 <lina:image src="pics/d-videocolordepth.png"/>
  149.             </blockquote>
  150.  
  151.             <p>
  152.                 Selects the desired image formats for video decompression and video compression.    
  153.             </p>
  154.  
  155.             <dl>
  156.                 <dt>Decompression format</dt>
  157.                 <dd>
  158.                     <p>
  159.                         Selects a color format to target when decompressing the input video.
  160.                     </p>
  161.                     <p>
  162.                         For a compressed source, this format is requested directly from the video codec. "Autoselect"
  163.                         will choose a common, safe RGB format, such as 24-bit, 32-bit, or 15-bit RGB.
  164.                     </p>
  165.                     <p>
  166.                         For an uncompressed source (or Avisynth script), the desired format is produced through image
  167.                         conversion if it is not the same as the source. YCbCr-to-YCbCr conversions do not round-trip
  168.                         through RGB. "Autoselect" chooses the source format so that no conversion is necessary.
  169.                     </p>
  170.                     <p>
  171.                         If the video codec cannot produce the format you have selected, VirtualDub will automatically
  172.                         attempt to degrade the video format to a similar format that is supported. For instance, if
  173.                         16-bit RGB fails, 24-bit RGB will be tried. The fallback code avoids color space conversions
  174.                         if possible; if a YCbCr format fails, other YCbCr formats will be tested before resorting
  175.                         to RGB.
  176.                     </p>
  177.                 </dd>
  178.  
  179.                 <dt>Output format</dt>
  180.                 <dd>
  181.                     <p>
  182.                         Selects a color format for output. During preview, this is the format sent to the display panes.
  183.                         When video compression is active, this selects the format received by the video compressor.
  184.                     </p>
  185.  
  186.                     <p>
  187.                         The output format is produced by conversion from the input format. When video filters are in
  188.                         use, the input format is converted to 32-bit RGB, processed, and the result converted to
  189.                         the output format. If video filters are not being used, the input format is converted directly
  190.                         to the output format.
  191.                     </p>
  192.  
  193.                     <lina:note>
  194.                         As is standard in GDI bitmaps, the 32-bit format has a dummy alpha channel, used only for
  195.                         padding. VirtualDub cannot currently target a 32-bit format with meaningful alpha.
  196.                     </lina:note>
  197.  
  198.                     <lina:note>
  199.                         The size of the output format doesn't necessarily relate to how well the output compresses
  200.                         through a video codec. For instance, converting from 24-bit RGB to 16-bit RGB can hinder
  201.                         compression, because it increases quantization noise (banding) in the image.
  202.                     </lina:note>
  203.                 </dd>
  204.             </dl>
  205.  
  206.             <h2>Format descriptions</h2>
  207.             <dl>
  208.                 <dt>16-bit RGB (555)</dt>
  209.                 <dd>This is a format with five bits per channel (32 levels) for each of red, green, and blue. It is
  210.                     a relatively low-precision format that is prone to some banding artifacts but is common on older
  211.                     video display hardware, as it is faster and consumes less memory than 24-bit RGB. This format
  212.                     is sometimes known as HiColor.</dd>
  213.  
  214.                 <dt>16-bit RGB (565)</dt>
  215.                 <dd>This is a slightly improved version of 16-bit RGB (555), as it uses the unused bit to improve
  216.                     precision in green.</dd>
  217.  
  218.                 <dt>24-bit RGB (888)</dt>
  219.                 <dd>This is a format with eight bits per channel (256 levels) for each of red, green, and blue. It
  220.                     is common for photographic images and is often known as TrueColor. This is the safest and most
  221.                     reliable format to use for video interchange.</dd>
  222.  
  223.                 <dt>32-bit RGB (8888) (dummy alpha channel)</dt>
  224.                 <dd>This is similar to 24-bit RGB, except that it has an additional unused eight bits per pixel.
  225.                     Picture quality is identical to 24-bit, but the additional padding makes the pixels a more
  226.                     convenient size for computation. This format is sometimes slightly faster than 24-bit for
  227.                     processing, but should be avoided for storage as it wastes one-third more space.</dd>
  228.  
  229.                 <dt>4:2:2 YCbCr (UYVY)</dt>
  230.                 <dd>This is a format which uses the YCbCr color space (luma, chroma-blue, chroma-red), which is
  231.                     closer to the way color images are perceived by the human brain. It averages only 16 bits per
  232.                     pixel with similar perceptual quality to 24-bit RGB by only storing color information at half
  233.                     horizontal resolution, producing slight color bleeding but only taking two-thirds as much space.
  234.                     <p>
  235.                         This format, as do all other YCbCr formats listed below, encodes luminance (Y) with
  236.                         a range of [16, 235] and chroma (Cb/Cr, or U/V), with a range of [16, 240].
  237.                     </p>
  238.                     <p>
  239.                     UYVY is accepted directly by many video codecs. Since many video codecs internally use color
  240.                     spaces similar to YCbCr, using this format with video codecs can speed up rendering.
  241.                     </p>
  242.                 </dd>
  243.  
  244.                 <dt>4:2:2 YCbCr (YUY2)</dt>
  245.                 <dd>This is the same as 4:2:2 YCbCr (UYVY), except for a shuffling of data bytes. It has the same
  246.                     quality and performance advantages as UYVY.
  247.                 </dd>
  248.  
  249.                 <dt>4:2:0 planar YCbCr (YV12)</dt>
  250.                 <dd>This is a YCbCr format with an average of 12 bits per pixel and half resolution both horizontally
  251.                     and vertically in color information. It thus takes 25% less space than UYVY or YUY2, but with some
  252.                     vertical bleeding. "Planar" refers to the organization of data in the format, where luma, chroma-blue,
  253.                     and chroma-red are stored separately.
  254.                     <p>
  255.                         Some codecs accept this format directly for further increases in performance over the 4:2:2
  256.                         formats. However, it should be avoided for interlaced video, where the loss of vertical color
  257.                         resolution can cause motion artifacts between fields.
  258.                     </p>
  259.                     <lina:note>
  260.                         Although 4:2:0 YCbCr formats exist that accommodate interlacing, the YV12 four-character code (FOURCC)
  261.                         denotes a specific 4:2:0 encoding that is non-interlaced.
  262.                     </lina:note>
  263.                 </dd>
  264.  
  265.                 <dt>4:2:2 planar YCbCr (YV16)</dt>
  266.                 <dd>This is a YCbCr format with an average of 16 bits per pixel and half horizontal resolution in
  267.                     color information.
  268.                     <p>
  269.                         The YV16 format is rare and not well supported by video codecs and playback applications,
  270.                         but is supported here for completeness.
  271.                     </p>
  272.                 </dd>
  273.  
  274.                 <dt>4:1:0 planar YCbCr (YVU9)</dt>
  275.                 <dd>This is a YCbCr format with an average of 9 bits per pixel and quarter resolution both horizontally
  276.                     and vertically in color information. YVU9 thus takes 43% less space than UYVY/YUY2 and 62% less
  277.                     space than 24-bit RGB, but at the cost of significant color bleeding.
  278.                 </dd>
  279.  
  280.                 <dt>Luminance only (Y8)</dt>
  281.                 <dd>Y8 is a monochrome format, and thus selecting it will cause video to be converted to grayscale.
  282.                     However, it only requires half of the space of UYVY or YUY2 at 8 bits per pixel.
  283.                     <p>
  284.                     Y8 uses the same luma scale as YCbCr, 16-240, so there is a very slight loss of luma precision
  285.                     compared to 24-bit RGB. However, conversion between Y8 and YCbCr formats is lossless in luma and
  286.                     extremely fast.
  287.                     </p>
  288.                 </dd>
  289.             </dl>
  290.  
  291.         </dialog>
  292.  
  293.         <dialog name="Video range" filename="d-videorange.html">
  294.             <blockquote>
  295.                 <lina:image src="pics/d-videorange.png"/>
  296.             </blockquote>
  297.  
  298.             <p>
  299.                 Selects a subset of the input to use.
  300.             </p>
  301.  
  302.             <dl>
  303.                 <dt>Input range</dt>
  304.                 <dd>
  305.                     Controls how much video at the beginning and ends of the source is skipped during processing,
  306.                     so that only a portion in the middle is used. All offsets can be set in either frames or
  307.                     milliseconds (ms).
  308.  
  309.                     <lina:note>
  310.                         Offsets persist even if you load a new file.
  311.                     </lina:note>
  312.  
  313.                     <lina:note>
  314.                         The end offset is the number of milliseconds from the end, not from the beginning.  It is
  315.                         usually easier to set start/end points from the position control (<em>HOME</em>/<em>END</em>).
  316.                     </lina:note>
  317.  
  318.                     <lina:note>
  319.                         You can only select a single range with this dialog; use the <em>delete frames</em> feature
  320.                         to extract multiple segments in a single pass.
  321.                     </lina:note>
  322.                 </dd>
  323.  
  324.                 <dt>Offset audio to maintain a/v sync</dt>
  325.                 <dd>
  326.                     Controls whether the start offset applies to the audio stream.  If unchecked, the start offset
  327.                     deletes frames only from the video stream, advancing it that many frames ahead of the audio stream.
  328.                     This will alter audio/video synchronization accordingly.
  329.                 </dd>
  330.  
  331.                 <dt>Cut off audio when video stream ends</dt>
  332.                 <dd>
  333.                     If the audio stream is longer than the video stream, this controls whether the extra audio
  334.                     is used or not.  Generally, players continue to show the last video frame while the remaining
  335.                     audio plays.
  336.                 </dd>
  337.             </dl>
  338.  
  339.         </dialog>
  340.  
  341.         <dialog name="Video compression" filename="d-videocompression.html">
  342.             <blockquote>
  343.                 <lina:image src="pics/d-videocompression.png"/>
  344.             </blockquote>
  345.  
  346.             <p>
  347.                 VirtualDub can use video codecs installed in Windows to compress video.
  348.  
  349.                 <lina:note>
  350.                     Video codecs are external drivers created by third parties and are not part of VirtualDub.
  351.                     VirtualDub does not install codecs by itself and does not provide any video compression technology of its own.
  352.                 </lina:note>
  353.             </p>
  354.  
  355.             <dl>
  356.                 <dt>Selecting a video codec</dt>
  357.                 <dd>
  358.                     Currently installed video codecs are listed in the top left pane; select a codec to use
  359.                     or choose "uncompressed RGB" to disable video compression. Once a codec is
  360.                     selected, diagnostic information appears on the right side.  Every codec has a unique
  361.                     <em>fourcc</em>, or four character code, associated with it.
  362.  
  363.                     <lina:note>
  364.                         Not all codecs are usable -- sometimes programs install versions of a codec designed
  365.                         only to decompress video, not to compress it. Also, sometimes the codecs are keyed
  366.                         to a particular program due to licensing concerns, and thus won't work in VirtualDub.
  367.                     </lina:note>
  368.  
  369.                     <lina:note>
  370.                         For performance reasons, many codecs split the video frame into equal-size tiles and
  371.                         thus require the frame width and height to be specific multiples of the tile size.
  372.                         Requiring the width to be a multiple of four pixels is very common. VirtualDub
  373.                         attempts to detect such limitations and displays any such information in the right
  374.                         pane. In some rare cases with broken codecs this check fails, and the result may
  375.                         be a "bad format" error when you attempt to begin compression.
  376.                     </lina:note>
  377.                 </dd>
  378.  
  379.                 <dt>Configuring the codec</dt>
  380.                 <dd>
  381.                     Some codecs accept <em>quality</em>, <em>data rate</em>, and <em>key frame interval</em>
  382.                     parameters. The higher the quality, generally the slower the codec runs and the larger
  383.                     the output, but the better the video looks after compression. By setting a data rate, you
  384.                     request that the codec attempt to produce output at a fixed size-per-time ratio, set
  385.                     in kilobytes/second. And by setting a key frame interval, you are enforcing that seek
  386.                     points are placed at regular intervals in the video in order to reduce wait time when
  387.                     seeking. Nearly all codecs support additional parameters, which can be set by pressing
  388.                     the <em>Configure</em> button. The dialog that appears is codec-specific; please consult
  389.                     the documentation for each codec for further details.
  390.  
  391.                     <lina:note>
  392.                         Codecs are designed for a particular range of frame sizes and compression ratios and
  393.                         perform inefficiently outside that range. In particular, for most codecs, setting Quality to 100
  394.                         is likely to produce ridiculous file sizes and may not even produce
  395.                         perfect-looking video. Small file size and perfect-quality video are mutually exclusive. If you need perfect quality and are willing to put up
  396.                         with large file sizes, lossless codecs exist that are created specifically for this
  397.                         purpose.
  398.                     </lina:note>
  399.  
  400.                     <lina:note>
  401.                         If the codec allows you to enter a key frame interval but you don't enter one, you may
  402.                         get a video with a single key frame at the beginning. This means that every time you
  403.                         seek backwards in the video the player will have to decompress the entire video from the start
  404.                         up to that point, which is a tad slow. Key frames generally have lower compression
  405.                         ratios, so the interval determines a tradeoff between seek latency and compression
  406.                         efficacy.
  407.                     </lina:note>
  408.  
  409.                     <lina:note>
  410.                         Data rates specified here only pertain to video. Make sure to allow for audio
  411.                         and for file structure overhead.
  412.                     </lina:note>
  413.  
  414.                     <lina:note>
  415.                         Many modern codecs do adaptive key frame placement and more complex data rate regulation,
  416.                         and place all their settings in their configuration dialog. Although the data rate
  417.                         entry in VirtualDub's configuration dialog is specified in units of kilo<b>bytes</b> per second,
  418.                         or 1024 bytes/sec, codec dialogs generally use kilo<b>bits</b> per second (Kbits/sec),
  419.                         or 1000 bits/sec (125 bytes/sec).
  420.                     </lina:note>
  421.                 </dd>
  422.             </dl>
  423.         </dialog>
  424.  
  425.         <dialog name="Audio filters" filename="d-audiofilters.html">
  426.             <blockquote>
  427.                 <lina:image src="pics/d-audiofilters.png"/>
  428.             </blockquote>
  429.  
  430.             <ul>
  431.                 <li><a href="audio-filters.html">Audio filter reference</a></li>
  432.             </ul>
  433.  
  434.             <p>
  435.                 VirtualDub's advanced audio filter mode supports a <em>filter graph model</em>, where you can chain
  436.                 filters in complex, branching configurations. Filters are represented by rectangular <em>nodes</em>
  437.                 on the graph; each node may have <em>input pins</em> on the left and <em>output pins</em> on the right.
  438.             </p>
  439.  
  440.             <dl>
  441.                 <dt>Adding and removing filter nodes</dt>
  442.                 <dd>
  443.                     To add filters, click the <em>Add...</em> button. This displays the <em>Add filter</em> subdialog,
  444.                     which displays a list of available filters. In that subdialog, click a filter entry and then <em>Add</em>
  445.                     to add the filter to the graph, or alternatively, double-click the filter entry. The subdialog
  446.                     stays up until you are done adding filters and close it. Filter nodes added by mistake can be
  447.                     removed by clicking on them and pressing the <em>Delete</em> key or button.
  448.                 </dd>
  449.  
  450.                 <dt>Connecting filter nodes</dt>
  451.                 <dd>
  452.                     To connect filters together, drag from an input pin of one node to the output pin of another.
  453.                     (You cannot connect two input pins or two output pins.) An arrow will be displayed showing the connection.
  454.                     As with nodes, connections may be selected and deleted. Since this process is rather tedious, by
  455.                     default the <em>auto-connect</em> option is enabled. Auto-connect ties the first unused
  456.                     output pin of the currently selected filter to the first input pin of the newly added filter, and
  457.                     then selects the new filter. Simple chains can then be established just by adding the filters
  458.                     sequentially.
  459.                 </dd>
  460.  
  461.                 <dt>Filter graph restrictions</dt>
  462.                 <dd>
  463.                     The following rules apply to audio filter graphs:
  464.                     <ul>
  465.                         <li>There must be exactly one "source" node.</li>
  466.                         <li>There must be exactly one "output" node.</li>
  467.                         <li>All pins must be connected.</li>
  468.                         <li>No cycles are allowed, although parallel branching is permitted.</li>
  469.                         <li>Parallel paths must run at the same speed.</li>
  470.                     </ul>
  471.                     The last rule means you can't take a stream, slow it down with "stretch", and then mix it back
  472.                     with itself.
  473.                 </dd>
  474.             </dl>
  475.         </dialog>
  476.         <dialog name="Audio interleaving" filename="d-audiointerleaving.html">
  477.             <blockquote>
  478.                 <lina:image src="pics/d-audiointerleaving.png"/>
  479.             </blockquote>
  480.  
  481.             <p>
  482.                 Although video clips have simultaneous audio and video streams that play at the same time, the files
  483.                 that contain them are a single stream. <em>Interleaving</em> fakes having two streams by slicing the
  484.                 audio and video streams into chunks and mixing them together in chunks by time. A player reading
  485.                 an interleaved file receives a little bit of audio, then a bit of video, and then more audio, etc., buffering
  486.                 them in memory for a short time before playing the two together. VirtualDub's <em>audio interleaving</em>
  487.                 dialog controls how interleaving is performed.
  488.             </p>
  489.  
  490.             <lina:note>
  491.                 Audio interleaving has absolutely <i>zero</i> impact on when audio plays -- regardless of how audio and
  492.                 video frames are scattered in an AVI file, they still maintain the same timing relationship, because
  493.                 the index block sequences them properly.
  494.             </lina:note>
  495.  
  496.             <lina:note>
  497.                 Interleaving audio and video is not necessary unless the file is stored on a medium that streams
  498.                 much more efficiently than it handles random access, such as a CD-ROM drive or transmission over the
  499.                 Internet. High-speed devices such as hard disks can handle playback from non-interleaved files without
  500.                 problem, which is a consideration as interleaving isn't free -- it costs a small amount of overhead
  501.                 in the file size.
  502.             </lina:note>
  503.  
  504.             <dl>
  505.                 <dt>Enable audio/video interleaving</dt>
  506.                 <dd>
  507.                     If this option is selected, audio blocks are interleaved between video frames throughout the file. If
  508.                     not, all of the audio is placed at the end.
  509.                 </dd>
  510.  
  511.                 <dt>Preload</dt>
  512.                 <dd>
  513.                     Players require a certain amount of audio to be buffered ahead of time before starting video playback.
  514.                     The <em>preload</em> option controls how much audio is placed at the beginning of the file before
  515.                     the first video frame, in milliseconds. Usual values for this are 500ms (half second) or 1000ms (full second).
  516.                     If this setting is improperly adjusted, the file may not play optimally on slow computers or slow
  517.                     devices, although with modern video players this is less of a concern.
  518.                 </dd>
  519.  
  520.                 <dt>Interleave interval</dt>
  521.                 <dd>
  522.                     Controls how often audio blocks are scattered throughout the file -- the shorter the interval, the less
  523.                     buffering required by the player, but the more overhead in the output file. If the interleaving interval
  524.                     is too large, players will have to seek back in forth in the file, which has the worst of both worlds since
  525.                     the interleaving won't allow the player to do large, contiguous reads in the file. Usual values for this
  526.                     option are either interleave once per frame (1 frame) or every half second (500ms).
  527.                 </dd>
  528.  
  529.                 <dt>Audio skew correction</dt>
  530.                 <dd>
  531.                     This isn't really an interleaving option, and is the only option here that actually does affect audio
  532.                     sync -- but it is here for lack of a better place. Audio delay basically shifts the audio track back and forth,
  533.                     either by dropping samples from the beginning or adding samples at the start (zero for PCM, duplicated
  534.                     first sample for compressed audio). Use this option to shift an audio track into place if it seems
  535.                     a bit off.
  536.  
  537.                     <lina:note>
  538.                         Audio compression may impede use of delays. Some formats, particularly, ADPCM, use large block sizes
  539.                         that will limit the granularity of adjustments. The MP3 format used in AVI, on the other hand, has a hack
  540.                         in its format that prevents applications from seeing the "true" block size of the format.
  541.                         The result is generally junk produced at the beginning of the MP3 stream, which may not
  542.                         produce the desired delay depending on the player.  An audio editor specifically designed to edit
  543.                         MPEG audio streams is required in these cases.
  544.                     </lina:note>
  545.                 </dd>
  546.             </dl>
  547.         </dialog>
  548.         <dialog name="Audio compression" filename="d-audiocompression.html">
  549.             <blockquote>
  550.                 <lina:image src="pics/d-audiocompression.png"/>
  551.             </blockquote>
  552.  
  553.             <p>
  554.                 VirtualDub can use audio codecs installed in Windows to compress video.
  555.  
  556.                 <lina:note>
  557.                     Audio codecs are external drivers created by third parties and are not part of VirtualDub.
  558.                     VirtualDub does not install codecs by itself and does not provide any audio compression technology of its own.
  559.                 </lina:note>
  560.             </p>
  561.             
  562.             <dl>
  563.                 <dt>Selecting a audio codec</dt>
  564.                 <dd>
  565.                     Currently installed audio codecs are listed on the left.  Select <em>No compression (PCM)</em>
  566.                     to disable audio compression, or choose a codec. Once a codec is chosen, the available
  567.                     compression formats produced by the codec are shown on the right. By default, VirtualDub
  568.                     only displays those formats that can be produced by the codec from the current audio
  569.                     source and filtering settings. Uncheck <em>show all formats</em> to display all formats
  570.                     allowed by the codec, but note that attempting a conversion unsupported by the codec will
  571.                     generally result in an error.
  572.  
  573.                     <lina:note>
  574.                         Not all codecs are usable -- sometimes programs install versions of a codec designed
  575.                         only to decompress audio, not to compress it. Also, sometimes the codecs are keyed
  576.                         to a particular program due to licensing concerns, and thus won't work in VirtualDub.
  577.                         In particular, codecs installed by some versions of Windows Media are not licensed
  578.                         for general use and won't work except for in an ASF file under Windows Media Player.
  579.                     </lina:note>
  580.  
  581.                     <lina:note>
  582.                         Installing two codecs that compress and decompress the same format may confuse
  583.                         VirtualDub.  This includes having more than one MP3 codec, or having both Windows
  584.                         Media Audio and "DivX Audio" installed.
  585.                     </lina:note>
  586.  
  587.                     <lina:note>
  588.                         There are four common versions of the <em>MPEG Layer-3</em> codec that appear the same,
  589.                         except for the compression formats supported:
  590.                         <ul>
  591.                             <li><tt>L3CODECX.ACM</tt> - no compression supported</li>
  592.                             <li><tt>L3CODECA.ACM</tt> (Advanced) - up to 56Kbps</li>
  593.                             <li><tt>L3CODECP.ACM</tt> (Professional) - up to 128Kbps</li>
  594.                             <li><tt>L3CODECP.ACM</tt> (Radium warez version) - up to 256Kbps</li>
  595.                         </ul>
  596.                         All four of these codecs are very similar and have the same ID in the Windows Audio
  597.                         Compression Manager, so two programs that come with different versions sometimes
  598.                         overwrite each others' codecs when installing. If you used to have certain MP3
  599.                         compression options and no longer have them, it's possible a program you recently
  600.                         installed has done this.
  601.                     </lina:note>
  602.                 </dd>
  603.  
  604.             </dl>
  605.         </dialog>
  606.         <dialog name="Audio conversion" filename="d-audioconversion.html">
  607.             <blockquote>
  608.                 <lina:image src="pics/d-audioconversion.png"/>
  609.             </blockquote>
  610.  
  611.             <p>
  612.                 The audio conversion dialog allows for conversion between different PCM audio formats,
  613.                 including changes in sampling frequency, sample precision, and channels.
  614.             </p>
  615.  
  616.             <lina:note>
  617.                 Audio conversion is only permitted if advanced filtering is off -- if advanced audio
  618.                 filtering is on, use the <em>resample</em> filter.
  619.             </lina:note>
  620.  
  621.             <dl>
  622.                 <dt>Sampling rate conversions</dt>
  623.                 <dd>
  624.                     Allows changes in the sampling rate of the audio stream, without changing the pitch
  625.                     of the audio itself (resampling). You can select one of the common sampling rates,
  626.                     or <em>custom</em> to resample to any other rate. Higher sampling rates represent higher
  627.                     frequencies better and give "brighter" audio, but consume more space.
  628.  
  629.                     <dl>
  630.                         <dt>Integral conversion</dt>
  631.                         <dd>
  632.                             Forces the conversion to operate by integral multiplies (one-half, one-third, twice, three times, etc).
  633.                             Use this if you want to convert to a integral factor of the original rate that's close but not
  634.                             exactly the same as one of the listed values, i.e. 22047.5Hz. If the frequency you select is
  635.                             exactly what you want then this option should be unchecked.
  636.                         </dd>
  637.  
  638.                         <dt>High quality</dt>
  639.                         <dd>
  640.                             Switches the resampling filter from point sampling to a triangle filter for better quality. This reduces
  641.                             aliasing, which sounds like noise or halo in the output.
  642.                         </dd>
  643.                     </dl>
  644.                     <lina:note>
  645.                         The sampling rate converter controlled by this dialog is rather antiquated and not very high-quality
  646.                         by today's standards. The <em>resample</em> filter introduced in VirtualDub 1.5 uses a 65-point windowed-sinc
  647.                         filter and produces better quality than the triangle filter allowed here. It is slated to replace this
  648.                         resampler as the primary resampler in a later version.
  649.                     </lina:note>
  650.                 </dd>
  651.  
  652.                 <dt>Precision</dt>
  653.                 <dd>
  654.                     Controls the accuracy of audio samples -- 8-bit samples only take half as much space as 16-bit, but
  655.                     can't represent soft sounds as accurately and have a higher noise floor.
  656.  
  657.                     <lina:note>
  658.                         8-bit should really only be used if you are outputting uncompressed PCM to another program that needs it,
  659.                         or aren't changing existing 8-bit PCM.  Otherwise, instinctually choose 16-bit.  Modern audio codecs work
  660.                         in different audio representations, such as subbands or cosines, and thus don't get better compression
  661.                         with 8-bit source than with 16-bit.
  662.                     </lina:note>
  663.                 </dd>
  664.  
  665.                 <dt>Channels</dt>
  666.                 <dd>
  667.                     <p>
  668.                         Allows conversion of stereo audio to mono or mono to stereo. For stereo-to-mono conversions, the two channels
  669.                         are summed at half amplitude (<tt>(l+r)/2</tt>).  For mono-to-stereo conversions, the single channel is replicated
  670.                         into the left and right outputs.
  671.                     </p>
  672.                     <p>
  673.                         The <em>left</em> and <em>right</em> options convert a stereo stream to mono by discarding the unwanted channel.
  674.                         This is particularly useful for some dual-language or karaoke produced, where two mono streams are stored
  675.                         as the left and right channels of a stereo track.
  676.                     </p>
  677.  
  678.                     <lina:note>
  679.                         For simple audio encodings such as PCM or ADPCM, dropping a stereo stream to mono halves the size of the
  680.                         audio stream. More complex encodings such as MP3, however, can encode a stereo stream as "center"
  681.                         and "side" tracks or volume differentials (mid/side and intensity modes of joint stereo). Such methods
  682.                         take advantage of similarities between the stereo channels and can make stereo relatively cheap to encode
  683.                         over mono.
  684.                     </lina:note>
  685.                 </dd>
  686.  
  687.                 <dt>Bandwidth required</dt>
  688.                 <dd>
  689.                     Shows how much space would be required per second of audio without compression (uncompressed PCM),
  690.                     in kilobytes per second (KB/s). CD-quality audio, for instance, requires 172KB/sec (176,400 bytes per second).
  691.                 </dd>
  692.             </dl>
  693.         </dialog>
  694.         <dialog name="Audio volume" filename="d-audiovolume.html">
  695.             <blockquote>
  696.                 <lina:image src="pics/d-audiovolume.png"/>
  697.             </blockquote>
  698.  
  699.             <p>
  700.                 Permits volume adjustments to audio, to make the audio louder or softer.
  701.             </p>
  702.  
  703.             <lina:note>
  704.                 VirtualDub hard clips when amplifying audio, so boosting the volume too much will result in distortion.
  705.             </lina:note>
  706.  
  707.             <lina:note>
  708.                 It is easier to make soft audio louder than to make loud audio softer -- if the source audio was so
  709.                 loud that it clipped during recording, introducing distortion, reducing volume after the fact won't
  710.                 remove the distortion. On the other hand, amplifying soft audio also amplifies quantization noise,
  711.                 which is particularly bad with 8-bit source. Try not to adjust volume more than you need to; it is
  712.                 better to record audio at the right volume in the first place.
  713.             </lina:note>
  714.         </dialog>
  715.  
  716.         <dialog name="Capture settings" filename="d-capturesettings.html">
  717.             <blockquote>
  718.                 <lina:image src="pics/d-capturesettings.png"/>
  719.             </blockquote>
  720.  
  721.             <p>
  722.                 Controls basic video capture settings.
  723.             </p>
  724.  
  725.             <dl>
  726.                 <dt>Wait for OK to capture</dt>
  727.                 <dd>If checked, a dialog is displayed after capture is initialized.  This minimizes click-to-capture delay.</dd>
  728.  
  729.                 <dt>Frame rate</dt>
  730.                 <dd>Controls how fast video frames are captured.
  731.                     <lina:note>Frame rates are rounded to the nearest microsecond period.</lina:note>
  732.                 </dd>
  733.  
  734.                 <dt>Round to nearest millisecond</dt>
  735.                 <dd>
  736.                     Some capture drivers only allow frame rates corresponding to integer periods in milliseconds.
  737.                     With such a driver, for instance, the two closest rates to 15 fps are 14.925 fps (67 ms) and 15.152 fps (66 ms).
  738.                     This button allows you to see the actual rate that would occur.
  739.                 </dd>
  740.             </dl>
  741.  
  742.             <h2>Obsolete settings</h2>
  743.             <p>
  744.                 Many settings that used to be in this dialog have been obsoleted or moved:
  745.             </p>
  746.  
  747.             <dl>
  748.                 <dt>Capture audio</dt>
  749.                 <dd>Now an option on the Audio menu.</dd>
  750.  
  751.                 <dt>Abort hotkey and button</dt>
  752.                 <dd>
  753.                     The abort hotkey is now always Esc. Also, it is program-local (VirtualDub must have focus for it to work).
  754.                 </dd>
  755.  
  756.                 <dt>Audio and video buffer limits, audio buffer size</dt>
  757.                 <dd>
  758.                     Set automatically.
  759.                 </dd>
  760.  
  761.                 <dt>Drop % limit, maximum index entries, lock video stream to audio</dt>
  762.                 <dd>
  763.                     These options applied only to AVICap (compatibility mode) capture, which is no longer supported.
  764.                 </dd>
  765.             </dl>
  766.  
  767.         </dialog>
  768.  
  769.         <dialog name="Preferences" filename="d-preferences.html">
  770.             <blockquote>
  771.                 <lina:image src="pics/d-preferences.png"/>
  772.             </blockquote>
  773.             <p>
  774.                 Sets application preferences.
  775.             </p>
  776.  
  777.             <p>Main tab:</p>
  778.             <dl>
  779.                 <dt>Output color depth</dt>
  780.                 <dd>
  781.                     Selects the default color precision for video display -- 24-bit looks better, but 16-bit is generally
  782.                     faster.  This does not affect file output.
  783.                 </dd>
  784.  
  785.                 <dt>Process priority</dt>
  786.                 <dd>
  787.                     Force VirtualDub to be at a higher or lower priority than other applications when processing files.
  788.                     VirtualDub will always use CPU time that goes unused by other programs, but you can use this setting
  789.                     to force it to use more or less CPU when other applications need it as well.
  790.                 </dd>
  791.  
  792.                 <dt>Automatically add extension to filenames when saving</dt>
  793.                 <dd>
  794.                     Controls whether file extensions (<tt>.avi</tt>) are automatically added when you type a filename
  795.                     without one in a save dialog.
  796.                 </dd>
  797.             </dl>
  798.  
  799.             <p>Display tab (none of these options affect file output):</p>
  800.             <dl>
  801.                 <dt>Enable 16-bit dithering</dt>
  802.                 <dd>
  803.                     If enabled, 24-bit images are dithered when displaying in 16-bit to reduce banding, at the cost
  804.                     of a little speed.
  805.                 </dd>
  806.                 
  807.                 <dt>Use DirectX for display panes</dt>
  808.                 <dd>
  809.                     Enables accelerated video display for the display panes. This usually results in
  810.                     much better display performance as well as a better looking, smoother (interpolated) image.
  811.                     Disabling this option forces use of the safest but slowest display mechanism, which uses
  812.                     Windows GDI to render video images.
  813.                 </dd>
  814.  
  815.                 <dt>Use DirectX when Terminal Services is active</dt>
  816.                 <dd>
  817.                     Enables accelerated video display over a remote session using Windows Terminal Services or
  818.                     Remote Desktop. Due to apparent bugs in the Terminal Server implementation, allowing DirectX
  819.                     acceleration in this mode can cause video to always display in the upper-left corner of the
  820.                     desktop, so by default VirtualDub disables acceleration when it detects a remote session.
  821.                     This is often faster anyway.
  822.                 </dd>
  823.  
  824.                 <dt>Use Direct3D</dt>
  825.                 <dd>
  826.                     Enables use of the Direct3D 9.0c accelerated 3D graphics API to display video. This enables
  827.                     use of the filtering options in the display panes to select between point sampling and
  828.                     bilinear filtering, and if the 3D device is powerful enough, bicubic filtering.
  829.                 </dd>
  830.  
  831.                 <dt>Use effect file</dt>
  832.                 <dd>
  833.                     Enables use of a D3DX effect file (<tt>.fx</tt>) to specify custom Direct3D vertex and pixel shaders
  834.                     to display video. This requires an additional DirectX system DLL to be installed and knowledge
  835.                     of the effect file format to create the appropriate effects. Consult the <a href="fxvideo.html">video
  836.                     shader reference</a> for details.
  837.                 </dd>
  838.  
  839.                 <dt>Use OpenGL</dt>
  840.                 <dd>
  841.                     Enables use of the OpenGL accelerated 3D graphics API to display video. This enables use of
  842.                     the filtering options in the display panes to select between point sampling and bilinear
  843.                     filtering. Note that use of OpenGL when an accelerated 3D device is not present may result
  844.                     in substantial performance degredation.
  845.                 </dd>
  846.             </dl>
  847.  
  848.             <p>Scene tab:</p>
  849.             <dl>
  850.                 <dt>Interframe (cut) and intraframe (fade) thresholds</dt>
  851.                 <dd>
  852.                     Controls the sensitivity of the scene forward/backward buttons on the position bar.
  853.                     A "scene change" is detected whenever there is a significant change in the image
  854.                     (cut), or scene details drop below a threshold (fade).
  855.                 </dd>
  856.             </dl>
  857.  
  858.             <p>CPU tab:</p>
  859.             <dl>
  860.                 <dt>Use default optimizations, or force specific optimizations</dt>
  861.                 <dd>
  862.                     By default, VirtualDub automatically detects your CPU and chooses appropriately optimized
  863.                     code paths.  If you experience problems due to incorrect detection, you can force specific
  864.                     codepaths on or off in this tab.  Note that enabling an optimization not supported by your
  865.                     CPU will result in a crash or incorrect execution.
  866.  
  867.                     <lina:note>
  868.                         Video and audio codecs do their own CPU-specific dispatch, and are not controllable by
  869.                         these settings.  If you experience problems with a codec that is not detecting your
  870.                         CPU correctly, you must contact the codec manufacturer for help.
  871.                     </lina:note>
  872.                 </dd>
  873.             </dl>
  874.  
  875.             <p>AVI tab:</p>
  876.             <dl>
  877.                 <dt>Restrict legacy AVI support to 1 gigabyte</dt>
  878.                 <dd>
  879.                     Extended AVI files (AVI 2.0 or OpenDML AVI) are composed of two parts: a legacy AVI portion,
  880.                     and extended AVI blocks.  This option drops the limit for the legacy portion from 2GB to 1GB,
  881.                     for applications that cannot handle AVI files between 1-2GB, and may be helpful if you have
  882.                     running applications that scan AVI files and choke on large ones.  It has no effect on
  883.                     programs that handle extended AVI files.
  884.                 </dd>
  885.  
  886.                 <dt>Do not correct MPEG layer III audio streams</dt>
  887.                 <dd>
  888.                     Some MP3 codecs do not generate MP3 streams at exactly the same rate as specified in their
  889.                     audio format when 44.1KHz sampling rates are used -- this causes a small discrepancy in
  890.                     audio sync of around 0.5%.  By default, VirtualDub recomputes the data rate and automatically
  891.                     corrects the audio header when MP3 compression is active.  This option allows you to disable
  892.                     correction if it is causing problems, such as an MP3 stream being generated in a format that
  893.                     VirtualDub cannot parse correctly.
  894.                 </dd>
  895.  
  896.                 <dt>Directly decode YCbCr (YUV) sources</dt>
  897.                 <dd>
  898.                     By default, VirtualDub will directly decode AVI video streams with uncompressed YCbCr
  899.                     formats that it recognizes, including UYVY, YUY2, YV16, YV12, I420, IYUV, Y41P, YVU9,
  900.                     Y8, and Y800, even if an external video codec would otherwise be used. This can result
  901.                     in better quality as VirtualDub uses bilinear interpolation when upsampling chroma.
  902.                     Disabling this option will disable YCbCr decode support and allow use of video codecs
  903.                     to handle such data.
  904.                 </dd>
  905.  
  906.                 <dt>Align large uncompressed frames to sector boundary</dt>
  907.                 <dd>
  908.                     Some self-contained, professional-level hardware playback devices attain higher performance when working with AVIs that
  909.                     have video frames aligned to sector boundaries on the disk rather than the simple
  910.                     two-byte alignment required by AVI. Enabling this option causes sector alignment to
  911.                     be used, at the cost of slightly larger AVI files. The additional alignment is
  912.                     only in effect when a recognized uncompressed video format is used and the size of
  913.                     the video frame exceeds the specified threshold size.
  914.                 </dd>
  915.             </dl>
  916.  
  917.             <p>Timeline page:</p>
  918.             <dl>
  919.                 <dt>Timeline format</dt>
  920.                 <dd>
  921.                     This option allows customization of the timestamp indicator on VirtualDub's main UI.
  922.                     Formatting specifiers — a percent sign followed by a letter — cause
  923.                     various pieces of information to be substituted into the given string. The permitted
  924.                     formatting specifiers are listed below the editable string.
  925.                 </dd>
  926.             </dl>
  927.  
  928.             <p>Render options:</p>
  929.             <dl>
  930.                 <dt>Confirm when abort button is pressed</dt>
  931.                 <dd>
  932.                     When enabled, attempts to abort a preview or save operation will cause a confirmation
  933.                     dialog to be displayed before actually aborting.
  934.                 </dd>
  935.             </dl>
  936.  
  937.         </dialog>
  938.     </dialog-docs>
  939. </lina:data>
  940.